home *** CD-ROM | disk | FTP | other *** search
/ Linux Programs 1995 Summer / Linux Programs.iso / raytrace / radiance.con / torad.README < prev    next >
Text File  |  1994-08-07  |  5KB  |  126 lines
  1. ***************************************************************************** 
  2.         torad.README
  3.  
  4.         This file is part of the program torad.lsp to export
  5.         RADIANCE scene description files from Autocad.
  6.  
  7.         Copyright (C) 1993 by Georg Mischler / Lehrstuhl
  8.                               fuer Bauphysik ETH Zurich.
  9.  
  10.         Permission to use, copy, modify, and distribute this software
  11.         for any purpose and without fee is hereby granted, provided
  12.         that the above copyright notice appears in all copies and that
  13.         both that copyright notice and this permission notice appear in
  14.         all supporting documentation.
  15.  
  16.         THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED
  17.         WARRANTY.  ALL IMPLIED WARRANTIES OF FITNESS FOR ANY PARTICULAR
  18.         PURPOSE AND OF MERCHANTABILITY ARE HEREBY DISCLAIMED.
  19.  
  20. *****************************************************************************
  21.  
  22. General info:
  23.     
  24.     torad.lsp
  25.         
  26.     Software extension for Autocad to export data to the RADIANCE light
  27.     simulation package of the Lawrence Berkeley Laboratory.
  28.  
  29.     Makes complete translation of all hiding/shading entities from
  30.     Autocad (and some more). 
  31.  
  32.     Entities can be selected on screen for partial export.
  33.  
  34.     Entities will be sorted by one of the three criteria color, layer or
  35.     insertion layer of blocks (toplayer) according to your choice.
  36.     The sorting results in seperate files written for every layer or color.
  37.     Floating layers and colors within blocks are fully supported.
  38.  
  39.     Other files created optionally can contain initial material definitions
  40.     (all identical), a list of "!cat" commands to include all the
  41.     information to make up a complete scene description, a setup of natural
  42.     lighting, a view description and a makefile for automatic image creation.
  43.  
  44.     Only the entities that are visible (that is their layer is on and thawed)
  45.     will be exported, even when nested in a selected block. This gives you
  46.     another method of filtering elements of your drawing especially usefull
  47.     when you want to update only part of a scene.
  48.  
  49.     The layername or color number will be part of each respective filename
  50.     to make it an unique identifier.
  51.  
  52.     You have full control through a sreen menu section, a text dialog
  53.     or even a interactive dialog box if you are running Autocad 12.
  54.  
  55.  
  56.     Entities exported (by choice):
  57.  
  58.     Autocad entities:            radiance objects:
  59.  
  60.     - 3dfaces                    -  triangular or quadrilateral polygons.
  61.     - extruded or flat traces    -  triangular and/or quadrilateral polygons.
  62.     - extruded or flat solids    -  triangular and/or quadrilateral polygons.
  63.     - extruded or flat circles   -  rings and quadrilateral polygons.
  64.     - extruded arcs              -  quadrilateral polygons.
  65.     - extruded lines             -  quadrilateral polygons.
  66.     - extruded 2d-plines         -  quadrilateral polygons.
  67.     - wide 2d-plines             -  multilateral polygons.
  68.     - closed 2d-plines           -  multilateral polygons.
  69.     - 3d-meshes                  -  triangular or quadrilateral polygons.
  70.     - polyfaces                  -  triangular or quadrilateral polygons.
  71.     - points                     -  spheres or bubbles.
  72.  
  73.  
  74.     torad.lsp is optimized for speed and memory usage as far as possible
  75.     without loosing the functionality of sorting entities to seperate files.
  76.     If you still consider it to be too slow, you will have to rewrite it
  77.     in C (or pay me for doing so ;-).
  78.  
  79.     But still, it really works!
  80.  
  81.  
  82.     the complete program consists of eight files (up to the moment):
  83.  
  84.     Program files:
  85.         torad.lsp       Main program source file.
  86.         esample.lsp     Entities sampling and conversion source file.
  87.         vector.lsp      Geometrical utilities source file.
  88.         torad.dcl       Dialog box definition file for Autocad 12.
  89.         torad.mnu/x     Menu file for setup with Autocad 10/11.
  90.  
  91.     Additional Files: 
  92.         torad.man       User manual. 
  93.         torad.README    This file. 
  94.  
  95.     All these files are packaged in both a compressed tar file and a
  96.     zip archieve to make them easily accessible for users of each unix
  97.     and dos systems.
  98.  
  99.  
  100. *****************************************************************************
  101.  
  102. "support"
  103.     I expect the program and the manual to be self explanatory for users
  104.     who have at least some experiance with either Autocad, Radiance or
  105.     better both of them. If there still remain questions that cannot be
  106.     answered neither through the manuals of Autocad, RADIANCE or torad.lsp
  107.     nor by the local guru, you might try to reach me by mail under
  108.     <mischler@arch.ethz.ch>.
  109.     Be sure to notify me if you think you have found a bug in this program
  110.     (there still might be some although thoroughly tested).
  111.     It may happen that you will have to wait a few days for an answer since
  112.     I am more like a guest at this site and therefore can not garantee
  113.     to look into my mail daily.
  114.  
  115.     Georg Mischler
  116.  
  117. *****************************************************************************
  118.  
  119. ACKNOWLEDGEMENTS
  120.     Final developement of this program has been sponsored by Prof. Dr.
  121.     B. Keller, Building Physics, Dep. for Architekture ETH Zurich.
  122.     The developement environment has been provided by Prof. Dr.
  123.     G. Schmitt, Architecture & CAAD ETH Zurich.
  124.  
  125. *****************************************************************************
  126.